<HTML><HEAD><TITLE>erase_all(+Key)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">Recorded Database</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>erase_all(+Key)</H1>
All the the values associated with key Key are removed from the indexed
database.


<DL>
<DT><EM>Key</EM></DT>
<DD>An atom, compound term or handle.
</DD>
</DL>
<H2>Description</H2>
   Used to remove all entries from the indexed database with the associated
   key Key.  In the case of compound terms, all keys of the same name and
   arity are treated as equal.

<P>

<H3>Modes and Determinism</H3><UL>
<LI>erase_all(+) is det
</UL>
<H3>Modules</H3>
This predicate is sensitive to its module context (tool predicate, see @/2).
<H3>Exceptions</H3>
<DL>
<DT><EM>(4) instantiation fault </EM>
<DD>Key is uninstantiated.
<DT><EM>(5) type error </EM>
<DD>Key is neither an atom nor a compound term.
</DL>
<H2>Examples</H2>
<PRE>
   Success:
   [eclipse]: record(whiskey,jameson),
   &gt;        record(whiskey,bushmills),
   &gt;        record(whiskey,glenfiddich),
   &gt;        record(whiskey,dimple).
   yes.
   [eclipse]: erase_all(whiskey).
   yes.
   [eclipse]: recorded(whiskey,L).
   no (more) solution.
   Error:
   erase_all(Key).                  (Error 4)
   erase_all("key").                (Error 5)
   erase_all(1).                    (Error 5)



</PRE>
<H2>See Also</H2>
<A HREF="../../kernel/record/erase-2.html">erase / 2</A>
</BODY></HTML>
